پرش به مطلب اصلی

کدهای وضعیت و خطاها

پلتفرم ما از کدهای وضعیت استاندارد HTTP برای نمایش نتیجه کلی درخواست استفاده می‌کند. علاوه بر این، در متن پاسخ (Body)، کدهای خطای داخلی (مانند D01 یا T05) برای تشخیص دقیق‌تر مشکل ارسال می‌شوند.

کدهای خطای داخلی​

در صورت بروز خطا، فیلد message و کدهای داخلی در بدنه پاسخ جزئیات بیشتری را ارائه می‌دهند. این کدها معمولاً به دسته‌های زیر تقسیم می‌شوند:

خطاهای ورودی (سری D)​

این خطاها زمانی رخ می‌دهند که داده‌های ارسالی شما ناقص یا اشتباه باشد (وضعیت 400).

کد داخلیتوضیحاتراه حل
D01شماره تلفن نامعتبر است.فرمت شماره را بررسی کنید.
D02کد پیامک باید عددی و بین 4 تا 16 رقم باشد.
(در سرویس Voice بازه 4 تا 8 است)		طول و فرمت code را بررسی کنید.
D03فرمت پیام ارسالی نامعتبر است.ساختار JSON را بررسی کنید.
D04ساختار پیام ارسالی صحیح نیست.فیلدهای موردنیاز را ارسال کنید.
D05نوع پیام‌رسان نامعتبر است.مقدار messenger_type را بررسی کنید.
D06کد ارسالی برای فلش کال باید 4 یا 5 رقمی باشد.طول کد را برای Flash Call بررسی کنید.
D07ایمیل ارسالی نامعتبر است.فرمت ایمیل را بررسی کنید.
D08نوع درخواست نامعتبر است.مقدار action را بررسی کنید.

خطاهای دسترسی و توکن (سری T)​

مربوط به اعتبار سنجی توکن و حساب کاربری (وضعیت 403, 404, 429).

کد داخلیتوضیحاتراه حل
T01توکن یافت نشدتوکن ارسالی در سیستم وجود ندارد. توکن جدید بسازید.
T02توکن قابل استفاده نیستسرویس یا توکن شما غیرفعال است.
T03دسترسی غیرمجاز
(عدم تطابق سرویس توکن با اکشن یا محدودیت‌های سیستمی)		نوع سرویس/اکشن یا محدودیت‌های ارسال را بررسی کنید.
T05اتمام سهمیه (Quota Exhausted)اعتبار حساب شما به پایان رسیده. کیف پول را شارژ کنید.

خطاهای شبکه و تامین‌کننده (سری N)​

مربوط به خطاهای زیرساختی سرویس (وضعیت 502).

کد داخلیتوضیحاتراه حل
N01سرویس خارج از دسترس است.کمی بعد دوباره تلاش کنید.

پاسخ نمونه خطا​

{
  "message": "نوع درخواست نامعتبر است.",
  "status": 400,
  "track_id": "6afc388b-43b0-4cd7-9e6b-cb4e020ad970",
  "error": {
    "code": "D08",
    "detail": "OTP action is invalid"
  }
}

نکته مهم​

در برخی خطاهای محدودیت (مانند COOLDOWN یا TOKEN_RATE) پاسخ با کد T03 و وضعیت 429 برمی‌گردد. در این حالت ممکن است هدر Retry-After نیز ارسال شود.